Some GDK doc additions

svn path=/trunk/; revision=20770

diff --git a/ChangeLog b/ChangeLog
index fbc879122acad7b7cac8703503a8e9b4b749910f..d24288801b5887e781e425918acd479e443cee44 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-07-04  Matthias Clasen  <mclasen@redhat.com>
+
+       * gdk/x11/gdktestutils-x11.c: Small doc fixes
+
 2008-07-04  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/tests/defaultvalue.c: Omit some more untestable properties.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index d9e48efca128344a6d1ec37f7e66c8373ec1e52b..1dadff3bd17ddefb8db8e0b97599665ff04c6d0d 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2008-07-04  Matthias Clasen  <mclasen@redhat.com>
+
+       * gdk/tmpl/events.sgml:
+       * gdk/tmpl/gdktesting.sgml: Additions
+
 2008-07-03  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/images/iconview.png: Update

diff --git a/docs/reference/gdk/tmpl/events.sgml b/docs/reference/gdk/tmpl/events.sgml
index f58d9c6cc02f14e2626acf5297d6379ee18bd9d9..b4dff1b5ef7d76ac91f782eb8d003389bb160f5b 100644 (file)
--- a/docs/reference/gdk/tmpl/events.sgml
+++ b/docs/reference/gdk/tmpl/events.sgml
@@ -92,7 +92,8 @@ for the possible window states
   was added in 2.6
 @GDK_GRAB_BROKEN: a pointer or keyboard grab was broken. This event type
   was added in 2.8.
-@GDK_DAMAGE: 
+@GDK_DAMAGE: the content of the window has been changed. This event type
+  was added in 2.14.
 
 <!-- ##### ENUM GdkEventMask ##### -->
 <para>

diff --git a/docs/reference/gdk/tmpl/gdktesting.sgml b/docs/reference/gdk/tmpl/gdktesting.sgml
new file mode 100644 (file)
index 0000000..e16ea19
--- /dev/null
+++ b/docs/reference/gdk/tmpl/gdktesting.sgml
@@ -0,0 +1,58 @@
+<!-- ##### SECTION Title ##### -->
+Testing
+
+<!-- ##### SECTION Short_Description ##### -->
+test utilities
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The functions in this section are intended to be used in test programs.
+They allow to simulate some user input.
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION gdk_test_render_sync ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gdk_test_simulate_button ##### -->
+<para>
+
+</para>
+
+@window: 
+@x: 
+@y: 
+@button: 
+@modifiers: 
+@button_pressrelease: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_test_simulate_key ##### -->
+<para>
+
+</para>
+
+@window: 
+@x: 
+@y: 
+@keyval: 
+@modifiers: 
+@key_pressrelease: 
+@Returns: 
+
+

diff --git a/gdk/x11/gdktestutils-x11.c b/gdk/x11/gdktestutils-x11.c
index 920a87a333d46a2a0c10565ce326ac4a20eace7f..c35b8a5ac457ebba8a25354802bf32c736f5331a 100644 (file)
--- a/gdk/x11/gdktestutils-x11.c
+++ b/gdk/x11/gdktestutils-x11.c
@@ -58,12 +58,14 @@ gdk_test_render_sync (GdkWindow *window)
  * If (@x,@y) are > (-1,-1), it will warp the mouse pointer to
  * the given (@x,@y) corrdinates within @window and simulate a
  * key press or release event.
+ *
  * When the mouse pointer is warped to the target location, use
  * of this function outside of test programs that run in their
  * own virtual windowing system (e.g. Xvfb) is not recommended.
  * If (@x,@y) are passed as (-1,-1), the mouse pointer will not
  * be warped and @window origin will be used as mouse pointer
  * location for the event.
+ *
  * Also, gtk_test_simulate_key() is a fairly low level function,
  * for most testing purposes, gtk_test_widget_send_key() is the
  * right function to call which will generate a key press event
@@ -162,6 +164,7 @@ gdk_test_simulate_key (GdkWindow      *window,
  * location, use of this function outside of test programs that
  * run in their own virtual windowing system (e.g. Xvfb) is not
  * recommended.
+ *
  * Also, gtk_test_simulate_button() is a fairly low level function,
  * for most testing purposes, gtk_test_widget_click() is the right
  * function to call which will generate a button press event followed